home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / _archvrs / unix / comp430 / readme4.0 < prev    next >
Text File  |  1990-01-17  |  3KB  |  88 lines
  1. README4.0 included for historical reasons. Many of the cautions, especially
  2. regarding the size of the memory model no longer apply. See README4.3 for 
  3. updates on these items.
  4.  
  5. Compress version 4.0 improvements:
  6.     o compress() speedup (10-50%) by changing division hash to xor
  7.     o decompress() speedup (5-10%)
  8.     o Memory requirements reduced (3-30%)
  9.     o Stack requirements reduced to less than 4kb
  10.     o Removed 'Big+Fast' compress code (FBITS) because of compress speedup
  11.         o Portability mods for Z8000 and PC/XT (but not zeus 3.2)
  12.     o Default to 'quiet' mode
  13.     o Unification of 'force' flags
  14.     o Manual page overhaul
  15.     o Portability enhancement for M_XENIX
  16.     o Removed text on #else and #endif
  17.     o Added "-V" switch to print version and options
  18.     o Added #defines for SIGNED_COMPARE_SLOW
  19.     o Added Makefile and "usermem" program
  20.     o Removed all floating point computations
  21.     o New programs:
  22.         compressdir - compress all files on a directory
  23.         uncompressdir - uncompress all files on a directory
  24.         zcmp - cmp compressed files
  25.         zdiff - diff compressed files
  26.       The following are with thanks to philabs!per:
  27.         btoa - convert binary to ascii for mailing
  28.         atob - convert ascii to binary with checksum
  29.         tarmail - tar, compress, btoa, and mail files
  30.         untarmail - restore "tarmail" files
  31.  
  32.         WARNING: These last few programs are not compatible
  33.         with the original ones from the net.  The encoding
  34.         has changed.  See btoa.c for more info.
  35.  
  36. The "usermem" script attempts to determine the maximum process size.  Some
  37. editing of the script may be necessary (see the comments).  If you can't get
  38. it to work at all, just create file "USERMEM" containing the maximum process
  39. size in decimal.
  40.  
  41. The following preprocessor symbols control the compilation of "compress.c":
  42.  
  43.     o USERMEM        Maximum process memory on the system
  44.     o SACREDMEM        Amount to reserve for other proceses
  45.     o SIGNED_COMPARE_SLOW    Unsigned compare instructions are faster
  46.     o NO_UCHAR        Don't use "unsigned char" types
  47.     o BITS            Overrules default set by USERMEM-SACREDMEM
  48.     o vax            Generate inline assembler
  49.     o interdata        Defines SIGNED_COMPARE_SLOW
  50.     o M_XENIX        Makes arrays < 65536 bytes each
  51.     o pdp11            BITS=12, NO_UCHAR
  52.     o z8000            BITS=12
  53.     o pcxt            BITS=12
  54.     o BSD4_2        Allow long filenames ( > 14 characters) &
  55.                 Call setlinebuf(stderr)
  56.  
  57. The difference "usermem-sacredmem" determines the maximum BITS that can be
  58. specified with the "-b" flag.
  59.  
  60. memory: at least        BITS
  61. ------  -- -----                ----
  62.      433,484             16
  63.      229,600             15
  64.      127,536             14
  65.       73,464             13
  66.            0             12
  67.  
  68. The default is BITS=16.
  69.  
  70. The maximum bits can be overrulled by specifying "-DBITS=bits" at
  71. compilation time.
  72.  
  73. WARNING: files compressed on a large machine with more bits than allowed by
  74. a version of compress on a smaller machine cannot be decompressed!  Use the
  75. "-b12" flag to generate a file on a large machine that can be uncompressed
  76. on a 16-bit machine.
  77.  
  78. The output of compress 4.0 is fully compatible with that of compress 3.0.
  79. In other words, the output of compress 4.0 may be fed into uncompress 3.0 or
  80. the output of compress 3.0 may be fed into uncompress 4.0.
  81.  
  82. The output of compress 4.0 not compatable with that of
  83. compress 2.0.  However, compress 4.0 still accepts the output of
  84. compress 2.0.  To generate output that is compatable with compress
  85. 2.0, use the undocumented "-C" flag.
  86.  
  87. Check the Makefile, then "make".
  88.